home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / comm / browskit.zip / README.TXT < prev   
Text File  |  1996-08-20  |  18KB  |  383 lines
  1. OFFLINE BROWSER CONSTRUCTION KIT
  2. Binary Executable Version
  3. SI Software - http://www.sisoftware.com/browskit/browskit.htm
  4. info@sisoftware.com
  5.  
  6.  
  7. 1. OBJECTIVE
  8. 2. INSTALLATION AND OPERATION
  9. 3. TECHNICAL NOTES 
  10. 4. ORDER INFORMATION
  11. 5. NOTES AND SAMPLE DOCUMENTATION FROM THE REGISTERED SOURCE CODE VERSION
  12. 6. LICENSE AGREEMENT
  13. 7. CONTACT AND ORDER INFORMATION
  14.  
  15. ***************************************************************************
  16. 1. OBJECTIVE
  17.  
  18. OFFLINE BROWSER CONSTRUCTION KIT unregistered binary executable version 
  19. downloads files from WWW (World Wide Web) sites using an "agent" or "agenda" 
  20. of URL's.  
  21.  
  22. (The registered version includes source code and documentation for http and
  23. ftp downloads as a tool to help programmers learn how to build their own 
  24. personal or commercial offline browser. Other desirable features are layed
  25. out on the main screen but are not supported)  
  26.  
  27. ***************************************************************************
  28.  
  29. 2. INSTALLATION AND OPERATING INSTRUCTIONS
  30.  
  31. OFFLINE BROWSER CONSTRUCTION KIT
  32.  
  33. EXECUTABLE BINARY VERSION
  34.  
  35.  
  36. 1. Unzip the file BROWSKIT.ZIP to a single directory
  37.  
  38. 2. Create Program Group And Icons As You Desire
  39.  
  40. 3. Use Text Editor or the program itself  to create "agents" or "agendas" 
  41. which are lists of URL's to visit, one on each line: 
  42.  
  43. EXAMPLE:
  44.  
  45. http://www.techweb.com
  46. http://www.iworld.com
  47. http://www.boardwatch.com
  48.  
  49. Save your "agent" as a text file with a ".NSF" file extension
  50.  
  51. EXAMPLE:
  52.  
  53. Save File As: zines.nsf
  54.  
  55.  
  56. 4. Click on nsurf.exe to run the program (or click on a .nsf agenda file 
  57. you have created)
  58.  
  59. (Please note that the screen is designed to support many features that 
  60. are not offered in this program. The only feature that your unregistered 
  61. version supports is download of selected WWW files.  It's simple, but it works!)
  62.  
  63.  
  64. 5. Select File, Open to run one of the .NSF files you created
  65.  
  66. OR:
  67.  
  68. Click ADD button to create list of URL's to download
  69.  
  70.  
  71. 6. Click BEGIN DOWNLOAD button to begin the download process. 
  72.  
  73. The application will download the selected htm, gif or jpg files 
  74. to the same directory and will create a clickable, browsable index 
  75. page of the downloaded files named 2.HTM
  76.  
  77. 7. Use any browser to view the index page named 2.HTM  This page indexes
  78. and links to the locally downloaded files and indicates any files that
  79. failed to download. You can use your browser to directly view any of the 
  80. saved files also.
  81.  
  82. **********************************************************************
  83.  
  84. OPERATION
  85.  
  86. This build  can only download files from WWW sites, using HTTP 
  87. (Hyper-Text Transfer Protocol).
  88.  
  89. Using either a text editor or OFFLINE BROWSER CONSTRUCTION KIT itself, 
  90. enter one or more WWW files for download. The format of the filenames 
  91. is the same as you would enter the file into a browser, for example, 
  92. http://www.netscape.com/index.html. You may enter any valid URL in 
  93. the "agenda or agent", a text file with a .nsf extension, including 
  94. .gif and .jpg files. Individual agent files cannot exceed 32K in size.
  95.  A warning is displayed if a .nsf file exceeds this length.
  96.  
  97. Click the "Begin Download" button to begin the download process. 
  98. The application will download the pages and display "Agenda Completed"
  99.  in the status bar when it is finished.
  100.  
  101. OFFLINE BROWSER CONSTRUCTION KIT downloads the files to the current 
  102. directory, creating an index at the same time. The index is named 2.htm.
  103.  Open this file with any browser to access the list of links to the 
  104. downloaded pages. Pages that failed to download are included in the 
  105. list with an error message, and they are not linked to any downloaded file.
  106.  
  107. Graphics within the web files are not automatically downloaded, 
  108. although the individual URLs of these files may be entered in the agenda.
  109.  
  110. The first time the program is run, it will register itself with Windows 
  111. so that anytime a .nsf file is run, the application will automatically 
  112. be called. By creating separate file folders with a .nsf agenda in each 
  113. folder, you can keep your agendas separate from one another.
  114.  
  115. **************************************************************************
  116.  
  117. 3. TECHNICAL NOTES
  118.  
  119. The OFFLINE BROWSER CONSTRUCTION KIT  16 Bit application uses Windows Sockets 
  120. (WINSOCK.DLL) for communicating with the Internet. A connection to the Internet
  121. is required before this program is executed. WINSOCK DLLs can vary from each 
  122. vendor, although the program had no problems with any particular implementations
  123. of Windows Sockets so far.
  124.  
  125.  
  126. **************************************************************************
  127.  
  128. 4. ORDER REGISTERED SOURCE CODE VERSION TODAY BY PHONE, FAX, E-MAIL, MAIL USING 
  129. ANY MAJOR CREDIT CARD:
  130.  
  131. Item #:14788 - OFFLINE BROWSER CONSTRUCTION KIT - $30
  132. Public Software Library - PsL
  133. P.O. Box 35705
  134. Houston, TX 77235-5705
  135.  
  136. 800-242-4775
  137. 713-524-6394
  138. FAX - 713-524-6398
  139. Compuserve E-Mail: 71355.470@compuserve.com
  140.  
  141. "THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY. THE PUBLISHER OF THIS 
  142. PROGRAM CANNOT BE REACHED FOR SALES AND TECHNICAL INFORMATION AT THESE NUMBERS"
  143.  
  144. "Any questions about product or order status? Contact: info@sisoftware.com"
  145.  
  146. ****************************************************************************
  147.  
  148. 5. NOTES AND SAMPLE DOCUMENTATION FROM THE REGISTERED SOURCE CODE VERSION
  149. (YOU HAVE THE UNREGISTERED VERSION, BELOW ARE BRIEF NOTES AND A PREVIEW OF 
  150. DOCUMENTATION ACCOMPANYING THE REGISTERED SOURCE CODE VERSION )
  151.  
  152. OFFLINE BROWSER CONSTRUCTION KIT is a 16-bit application written in Visual C++ 
  153. version 1.52c. It uses Microsoft Foundation Classes, and makes use of two royalty-free, 
  154. distributable .vbx files (Visual Basic controls)  to implement the tabbed-dialog 
  155. control in the lower portion of the application's main window.
  156.  
  157. Here is a brief description of the  project's files:
  158.  
  159. Implementation of the "Add Agenda" dialog
  160. Implementation of the "Terms of License" dialog
  161. The CMainFrame class, derived from CFrameWnd
  162. The CNsurfApp application class, derived from CWinApp
  163. The CNsurfDoc document class, derived from CDocument
  164. The CNsurfView form class, derived from CFormView, and the CTabDlg dialog class, 
  165. derived from CDialog
  166. The CSockWnd window class, derived from CWnd
  167. Standard MFC file for generating precompiled headers
  168. The CInternet class, derived from CSocket
  169. The Windows resource file
  170. License message that appears in "Terms of License"
  171. Windows module definition file
  172. Application icon
  173. Application toolbar images
  174. Windows 16-bit executable
  175. FarPoint "Imprint" VBX
  176. FarPoint "Tab" VBX
  177.  
  178. The NSurf16 project makes use of MFC's Document/View architecture to facilitate 
  179. reading and writing of the .nsf agenda files. The contents of the .nsf file is 
  180. held in the CNsurfDoc member variable m_strAgenda.
  181.  
  182. CNsurfView is the SDI dialog, associated with resource IDD_NSURF_FORM. This 
  183. class is responsible for parsing the agenda file (using CNsurfDoc), managing 
  184. internet connections (using CSockWnd), and saving the downloaded files. CNsurfView 
  185. downloads as many as four files at a time by creating a CSockWnd for each file. 
  186. CSockWnd uses the CInternet class to asynchronously download a file. When a file 
  187. is successfully downloaded or fails download, CSockWnd notifies the CNsurfView 
  188. window of the status, and the 
  189.  
  190. CSockWnd is destroyed. When a CSockWnd is finished downloading a file, the entire 
  191. contents of the file remain in a buffer, which is transferred to a newly-created 
  192. file. The file is named according to the original filename at the end of the URL. 
  193. If the filename cannot be derived from the URL, a filename with a unique number 
  194. is generated. In either case, the filename is added to the master contents file "2.htm".
  195.  
  196. The asynchronous operation of OBKC is implemented using the OnIdle method...
  197.  
  198. THE REGISTERED VERSION ALSO INCLUDES FTP EXECUTABLE AND SOURCE
  199. (which follows MFC)
  200.  
  201. (Sample Of Documentation - Please Order Registered Version For Complete Source Code 
  202. And Documentation - ORDER INSTRUCTIONS ARE FOUND ON FOLLOWING PAGES)
  203.  
  204. ********************************************************************